<html xmlns:j2ee="http://java.sun.com/xml/ns/j2ee" xmlns:fo="http://www.w3.org/1999/XSL/Format">
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>option
          (Stripes 1.5.6 Tag Library Documentation)
        </title>
<meta name="keywords" content="$title">
<link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
</head>
<script>
            function asd()
            {
            parent.document.title="option (Stripes 1.5.6 Tag Library Documentation)";
            }
          </script>
<body bgcolor="white" onload="asd();">
<a name="navbar_top"></a>
<table border="0" width="100%" cellpadding="1" cellspacing="0">
<tr>
<td COLSPAN="3" BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><a NAME="navbar_top_firstrow"></a>
<table BORDER="0" CELLPADDING="0" CELLSPACING="3">
<tr ALIGN="center" VALIGN="top">
<td BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    &nbsp;<a href="../overview-summary.html"><font CLASS="NavBarFont1"><b>Overview</b></font></a>&nbsp;</td><td BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    &nbsp;<a href="tld-summary.html"><font CLASS="NavBarFont1"><b>Library</b></font></a>&nbsp;</td><td BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<font CLASS="NavBarFont1Rev">&nbsp;Tag&nbsp;</font>&nbsp;</td><td BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    &nbsp;<a HREF="../help-doc.html"><font CLASS="NavBarFont1"><b>Help</b></font></a>&nbsp;</td>
</tr>
</table>
</td><td ALIGN="right" VALIGN="top" ROWSPAN="3"><em></em></td>
</tr>
<tr>
<td BGCOLOR="white" CLASS="NavBarCell2"><font SIZE="-2"></font></td><td BGCOLOR="white" CLASS="NavBarCell2"><font SIZE="-2">
                &nbsp;<a HREF="../index.html" TARGET="_top"><b>FRAMES</b></a>&nbsp;
                &nbsp;<a href="option.html" target="_top"><b>NO FRAMES</b></a>&nbsp;
                <script></script>
<noscript>
<a HREF="../alltags-noframe.html" TARGET=""><b>All Tags</b></a>
</noscript>
</font></td>
</tr>
</table>
<hr>
<h2>
<font size="-1">Stripes Tag Library</font>
<br>
            Tag option</h2>
<hr>
            <p>Generates an &lt;option value=&quot;foo&quot;&gt;Fooey&lt;/option&gt; HTML tag.
            Coordinates with an enclosing select tag to determine its state (i.e. whether or not
            it is selected.)  As a result some of the logic regarding state repopulation is a bit
            complex.</p>

            <p>Since options can have only a single value per option the value attribute of the tag
            must be a scalar, which will be converted into a String using a Formatter if an
            appropriate one can be found, otherwise the toString() method will be invoked.The
            presence of a &quot;selected&quot; attribute is used as an indication that this option
            believes it should be selected by default - the value (as opposed to the presence)
            of the selected attribute is never used....</p>

            <p>The option tag delegates to its enclosing select tag to determine whether or not it
            should be selected.  See the stripes:select for documentation on how it determines
            selection status.  If the select tag <em>has no opinion</em> on selection state
            (note that this is not the same as select tag deeming the option should not be selected)
            then the presence of the selected attribute (or lack thereof) is used to turn selection
            on or off.</p>

            <p>If the option has a body then the String value of that body will be used to generate
            the body of the generated HTML option.  If the body is empty or not present then the
            label attribute will be written into the body of the tag.</p>

            <p>If the label attribute's value is used, it will be HTML-encoded before being written
            out. However, the tag body, if present, will <em>not</em> be HTML-encoded. This allows
            the explicit use of HTML character entities within the tag, which would be impossible
            otherwise. If you choose to set the tag body and you want the output to be HTML-encoded,
            you must use something like the escapeXml attribute of the &lt;c:out&gt; tag to
            HTML-encode the value before passing it to &lt;stripes:option&gt;.</p>
        <br>
<p></p>
<hr>
<table border="1" cellpadding="3" cellspacing="0" width="100%">
<tr bgcolor="#CCCCFF" class="TableHeadingColor">
<td colspan="2"><font size="+2"><b>Tag Information</b></font></td>
</tr>
<tr>
<td>Tag Class</td><td>net.sourceforge.stripes.tag.InputOptionTag</td>
</tr>
<tr>
<td>TagExtraInfo Class</td><td><i>None</i></td>
</tr>
<tr>
<td>Body Content</td><td>JSP</td>
</tr>
<tr>
<td>Display Name</td><td>option</td>
</tr>
</table>
<br>
<p></p>
<table border="1" cellpadding="3" cellspacing="0" width="100%">
<tr bgcolor="#CCCCFF" class="TableHeadingColor">
<td colspan="5"><font size="+2"><b>Attributes</b></font></td>
</tr>
<tr>
<td><b>Name</b></td><td><b>Required</b></td><td><b>Request-time</b></td><td><b>Type</b></td><td><b>Description</b></td>
</tr>
<tr valign="top">
<td>value</td><td>false</td><td>true</td><td><code>java.lang.Object</code></td><td>
                The value that will be submitted to the server if this option is selected. Will be
                rendered as a String using the Stripes Formatting service, which will apply a
                formatter if an applicable one is found, or call toString() if one is not.
            </td>
</tr>
<tr valign="top">
<td>label</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>A value to use as the body of the generated HTML label tag.</td>
</tr>
<tr valign="top">
<td>selected</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>
                If present, and the parent select tag had no value= attribute, causes
                the option to be selected by default.  The value is ignored, only presence in meaningful.
            </td>
</tr>
<tr valign="top">
<td>disabled</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Disables the input element when it first loads so that the user can not write text in it, or select it. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>formatType</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>The type used to format the object. If the value is a date, valid values are 'date', 'time' and 'datetime'. If the value is a Number, valid values are 'number', 'percentage' and 'currency'.</td>
</tr>
<tr valign="top">
<td>formatPattern</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>The pattern to apply. Can be either a named pattern or an actual pattern as understood by java.text.DateFormat or java.text.NumberFormat as appropriate for the type of object being formatted.</td>
</tr>
<tr valign="top">
<td>accesskey</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Keyboard shortcut to access the element. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>class</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>The CSS class to be applied to the element. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>dir</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Text direction. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>id</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>A unique identifier for the HTML tag on the page. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>lang</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>The language code of the element. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onblur</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when the element loses focus. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onchange</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when the element changes. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onclick</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run on each mouse click. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>ondblclick</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run on a double-click of the mouse. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onfocus</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when the element acquires focus. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onkeydown</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when a key is depressed. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onkeypress</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when a key is pressed and released. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onkeyup</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when a key is released. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onmousedown</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when a mouse button is depressed. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onmousemove</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when the mouse pointer is moved. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onmouseout</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when the mouse pointer moves out of the element. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onmouseover</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when the mouse pointer moves over the element. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onmouseup</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when a mouse button is released. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>onselect</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Scripting code run when an element is selected. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>style</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Inline CSS style fragment that applies to the element (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>tabindex</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>The tab order of the element. (HTML Pass-through)</td>
</tr>
<tr valign="top">
<td>title</td><td>false</td><td>true</td><td><code>java.lang.String</code></td><td>Tool-tip text for the element. (HTML Pass-through)</td>
</tr>
</table>
<br>
<p></p>
<table border="1" cellpadding="3" cellspacing="0" width="100%">
<tr bgcolor="#CCCCFF" class="TableHeadingColor">
<td colspan="5"><font size="+2"><b>Variables</b></font></td>
</tr>
<td colspan="2"><i>No Variables Defined.</i></td>
</table>
<br>
<p></p>
<a name="navbar_bottom"></a>
<table border="0" width="100%" cellpadding="1" cellspacing="0">
<tr>
<td COLSPAN="3" BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><a NAME="navbar_bottom_firstrow"></a>
<table BORDER="0" CELLPADDING="0" CELLSPACING="3">
<tr ALIGN="center" VALIGN="top">
<td BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    &nbsp;<a href="../overview-summary.html"><font CLASS="NavBarFont1"><b>Overview</b></font></a>&nbsp;</td><td BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    &nbsp;<a href="tld-summary.html"><font CLASS="NavBarFont1"><b>Library</b></font></a>&nbsp;</td><td BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<font CLASS="NavBarFont1Rev">&nbsp;Tag&nbsp;</font>&nbsp;</td><td BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    &nbsp;<a HREF="../help-doc.html"><font CLASS="NavBarFont1"><b>Help</b></font></a>&nbsp;</td>
</tr>
</table>
</td><td ALIGN="right" VALIGN="top" ROWSPAN="3"><em></em></td>
</tr>
<tr>
<td BGCOLOR="white" CLASS="NavBarCell2"><font SIZE="-2"></font></td><td BGCOLOR="white" CLASS="NavBarCell2"><font SIZE="-2">
                &nbsp;<a HREF="../index.html" TARGET="_top"><b>FRAMES</b></a>&nbsp;
                &nbsp;<a href="option.html" target="_top"><b>NO FRAMES</b></a>&nbsp;
                <script></script>
<noscript>
<a HREF="../alltags-noframe.html" TARGET=""><b>All Tags</b></a>
</noscript>
</font></td>
</tr>
</table>
<hr>
<small><i>
            Output Generated by 
            <a href="http://taglibrarydoc.dev.java.net/" target="_blank">Tag Library Documentation Generator</a>.
            Java, JSP, and JavaServer Pages are trademarks or 
            registered trademarks of Sun Microsystems, Inc. in the US and other
            countries.  Copyright 2002-4 Sun Microsystems, Inc.
            4150 Network Circle
            Santa Clara, CA 95054, U.S.A.
            All Rights Reserved. 
            </i></small>
</body>
</html>
